Add annotations
authorMatthias Clasen <mclasen@redhat.com>
Fri, 17 Sep 2010 04:18:20 +0000 (00:18 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Fri, 17 Sep 2010 04:18:20 +0000 (00:18 -0400)
The goi scanner warns about these nowadays.

gdk/gdkdevice.c
gdk/gdkdnd.c
gdk/gdkvisual.c
gdk/gdkwindow.c
gdk/x11/gdkdisplay-x11.c
gdk/x11/gdkdnd-x11.c
gdk/x11/gdkinput.c
gdk/x11/gdkscreen-x11.c
gdk/x11/gdkvisual-x11.c
gdk/x11/gdkwindow-x11.c

index 19fa1dca65e2d4c04f5075e20602275adb60e1f4..5c62e091ae22cecc553ab9e8239a65be8416bc93 100644 (file)
@@ -830,7 +830,8 @@ gdk_device_get_n_axes (GdkDevice *device)
  * Returns a #GList of #GdkAtom<!-- -->s, containing the labels for
  * the axes that @device currently has.
  *
- * Returns: A #GList of #GdkAtom<!-- -->s, free with g_list_free().
+ * Returns: (transfer container) (element-type GdkAtom):
+ *     A #GList of #GdkAtom<!-- -->s, free with g_list_free().
  *
  * Since: 3.0
  **/
index b080ebebe001f1e96e9ad8d4c33008a77ba97009..695a5b2b7f9454b2d39016e8c6b6823037bda084 100644 (file)
@@ -99,7 +99,7 @@ gdk_drag_get_protocol (GdkNativeWindow  xid,
  *
  * Retrieves the list of targets of the context.
  *
- * Return value: a #GList of targets
+ * Return value: (transfer none) (element-type GdkAtom): a #GList of targets
  *
  * Since: 2.22
  **/
index 2be52af709394d80bdb322835c9b05d934562f4c..2501a09229a3a7cd9a21018c1da9cc1f4e8828ec 100644 (file)
@@ -37,7 +37,8 @@
  *
  * Call g_list_free() on the return value when you're finished with it.
  * 
- * Return value: a list of visuals; the list must be freed, but not its contents
+ * Return value: (transfer container) (element-type GdkVisual):
+ *     a list of visuals; the list must be freed, but not its contents
  **/
 GList*
 gdk_list_visuals (void)
index c2fcb5a21fb3d3e0a3597cea404ae446b065fc34..a1f89f79b21003b7d032c8c39376a5d9de7bb3fd 100644 (file)
@@ -2468,7 +2468,8 @@ gdk_window_get_effective_toplevel (GdkWindow *window)
  * The returned list must be freed, but the elements in the
  * list need not be.
  *
- * Return value: list of child windows inside @window
+ * Return value: (transfer container) (element-type GdkWindow):
+ *     list of child windows inside @window
  **/
 GList*
 gdk_window_get_children (GdkWindow *window)
@@ -2488,7 +2489,8 @@ gdk_window_get_children (GdkWindow *window)
  * Like gdk_window_get_children(), but does not copy the list of
  * children, so the list does not need to be freed.
  *
- * Return value: a reference to the list of child windows in @window
+ * Return value: (transfer none) (element-type GdkWindow):
+ *     a reference to the list of child windows in @window
  **/
 GList *
 gdk_window_peek_children (GdkWindow *window)
@@ -2617,7 +2619,8 @@ gdk_window_remove_filter (GdkWindow     *window,
  * The returned list should be freed with g_list_free(), but
  * its elements need not be freed.
  *
- * Return value: list of toplevel windows, free with g_list_free()
+ * Return value: (transfer container) (element-type GdkWindow):
+ *     list of toplevel windows, free with g_list_free()
  *
  * Since: 2.2
  **/
index 59c760051e2bb9fcb481655a91b18e20e902544d..31f9ec12d7f33ff2f12d9e0d81880a15a4e5b80f 100644 (file)
@@ -2484,7 +2484,8 @@ gdk_display_supports_composite (GdkDisplay *display)
  * Returns the list of available input devices attached to @display.
  * The list is statically allocated and should not be freed.
  *
- * Return value: a list of #GdkDevice
+ * Return value: (transfer none) (element-type GdkDevice):
+ *     a list of #GdkDevice
  *
  * Since: 2.2
  *
index 210cbaa2523692607579f60ac704dfb2ad9bfce8..6835a66483fb54b7edeed81e6f6f206baccf2cc2 100644 (file)
@@ -3154,7 +3154,8 @@ gdk_drag_do_leave (GdkDragContext *context, guint32 time)
 /**
  * gdk_drag_begin:
  * @window: the source window for this drag.
- * @targets: the offered targets, as list of #GdkAtom<!-- -->s
+ * @targets: (transfer none) (element-type GdkAtom): the offered targets,
+ *     as list of #GdkAtom<!-- -->s
  * 
  * Starts a drag and creates a new drag context for it.
  *
index ff69cebc1b0e8544084db8bc6609b93deece8e77..9c353af392a483db5c3a51ab8b25ce8f079debb2 100644 (file)
@@ -51,7 +51,7 @@ struct _GdkInputWindow
  * Returns the list of available input devices for the default display.
  * The list is statically allocated and should not be freed.
  *
- * Return value: a list of #GdkDevice
+ * Return value: (transfer none) (element-type GdkDevice): a list of #GdkDevice
  *
  * Deprecated: 3.0: Use gdk_device_manager_list_devices() instead.
  **/
index 44abed2cc3082b75b74b1d5969c4c0caabd91bad..e3c0d74e9c64832b8998c37d67b694f829ecad5c 100644 (file)
@@ -1410,7 +1410,8 @@ gdk_screen_get_active_window (GdkScreen *screen)
  * windows it contains, so it should be freed using g_list_free() and
  * its windows unrefed using g_object_unref() when no longer needed.
  *
- * Return value: a list of #GdkWindow<!-- -->s for the current window stack,
+ * Return value: (transfer full) (element-type GdkWindow):
+ *     a list of #GdkWindow<!-- -->s for the current window stack,
  *               or %NULL.
  *
  * Since: 2.10
index 2183294bdbbb2928f930511b01c3411f11e6e411..e9842418243edc8f195b4bf129506a701dec0a0c 100644 (file)
@@ -521,8 +521,8 @@ gdk_query_visual_types (GdkVisualType **visual_types,
  *
  * Call g_list_free() on the return value when you're finished with it.
  * 
- * Return value: a list of visuals; the list must be freed, but not its 
- * contents
+ * Return value: (transfer container) (element-type GdkVisual):
+ *     a list of visuals; the list must be freed, but not its contents
  *
  * Since: 2.2
  **/
index aff986a4faf0550e747bf2ad0afe49a1e26cf914..59d412fd7fac08ae72fed023196a964d7212341b 100644 (file)
@@ -3614,7 +3614,8 @@ gdk_x11_window_set_user_time (GdkWindow *window,
 /**
  * gdk_window_set_icon_list:
  * @window: The #GdkWindow toplevel window to set the icon of.
- * @pixbufs: A list of pixbufs, of different sizes.
+ * @pixbufs: (transfer none) (element-type GdkPixbuf):
+ *     A list of pixbufs, of different sizes.
  *
  * Sets a list of icons for the window. One of these will be used
  * to represent the window when it has been iconified. The icon is